Inside Macintosh: 3D Graphics Programming With QuickDraw 3D /

Chapter 3 - QuickDraw 3D Objects / QuickDraw 3D Objects Reference

Application-Defined Routines /

TQ3ElementCopyGetMethod

You can define a method to copy the data of your custom element types when that data is being retrieved from a set.

typedef TQ3Status (*TQ3ElementCopyGetMethod) (
const void *fromInternalElement, 
void *toAPIElement);

fromInternalElement

A pointer to the element data associated with an element having your custom element type.

toAPIElement

On entry, a pointer to an empty, zeroed block of memory large enough to contain the element data associated with an element having your custom element type.

DESCRIPTION

Your TQ3ElementCopyGetMethod function should copy the element data pointed to by the fromInternalElement parameter into the location pointed to by the toAPIElement parameter. This method is called whenever the Q3Set_Get or Q3AttributeSet_Get function is used to get the data of an element of your custom type in a set. The toAPIElement parameter contains the same data pointer that was passed to Q3Set_Get or Q3AttributeSet_Get.

RESULT CODES

Your TQ3ElementCopyGetMethod function should return kQ3Success if it is successful and kQ3Failure otherwise.